Add a warning about the semantics of gtk_recent_chooser_add_filter() and

2006-08-14  Emmanuele Bassi  <ebassi@gnome.org>

	* gtk/tmpl/gtkrecentchoosermenu.sgml: Add a warning about
	the semantics of gtk_recent_chooser_add_filter() and of
	gtk_recent_chooser_remove_filter() when applied to a
	GtkRecentChooserMenu.

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 531338e4978500d26abd21857862123d55795398..e90c765812216c5e576a1a8190013d04666e0500 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,10 @@
+2006-08-14  Emmanuele Bassi  <ebassi@gnome.org>
+
+       * gtk/tmpl/gtkrecentchoosermenu.sgml: Add a warning about
+       the semantics of gtk_recent_chooser_add_filter() and of
+       gtk_recent_chooser_remove_filter() when applied to a
+       GtkRecentChooserMenu.
+
 2006-08-14  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/tmpl/gtkruler.sgml: Fix a swapped argument 

diff --git a/docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml b/docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml
index ba1659dd1bbadd10fc41155b6a2d455720d00639..79d515b18c50cd68f6e9893251bcde084f6812d5 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkrecentchoosermenu.sgml
@@ -16,6 +16,18 @@ Note that #GtkRecentChooserMenu does not have any methods of its own.  Instead,
 you should use the functions that work on a #GtkRecentChooser.
 </para>
 
+<para>
+Note also that #GtkRecentChooserMenu does not support multiple filters, as it
+has no way to let the user choose between them as the #GtkRecentChooserWidget
+and #GtkRecentChooserDialog widgets do. Thus using gtk_recent_chooser_add_filter()
+on a #GtkRecentChooserMenu widget will yield the same effects as using
+gtk_recent_chooser_set_filter(), replacing any currently set filter
+with the supplied filter; gtk_recent_chooser_remove_filter() will remove
+any currently set #GtkRecentFilter object and will unset the current filter;
+gtk_recent_chooser_list_filters() will return a list containing a single
+#GtkRecentFilter object.
+</para>
+
 <para>
 Recently used files are supported since GTK+ 2.10.
 </para>